SetUserPref

導入

v1.0

カテゴリ

プロパティ編集

詳細

ユーザ プリファレンスを設定し、以前の設定値を戻します。 これらのユーザ プリファレンス設定の一部は[ユーザ設定]ダイアログ ボックスの設定と同じです。また、その一部にはメイン コントロール パネルから設定できる項目もあります。 使用できる設定のリストについては、UserPreferenceを参照してください。

注: 「AutoInspectEnabled」(siAutoInspect)プリファレンスを、スクリプティングによって永続的にに変更することはできません。 詳細については、「プロパティ エディタの自動検証」を参照してください。

スクリプト構文

oVariant = SetUserPref( Target, Value );

戻り値

以前の値(更新直前の値)をVariantとして戻します。

パラメータ

パラメータ タイプ 詳細
Target UserPreference 設定するユーザ プリファレンス。
Variant ユーザ プリファレンスの新しい値。 これらの値は、UserPreference パラメータに指定する値により異なります。

各 UserPreference 設定に有効な値タイプのリストについては、UserPreferenceを参照してください。

1. Python の例

# 
# This example demonstrates how to temporarily change the user's
# AutoInspect preference (if enabled, property pages always pop
# up for objects newly created via command). It also illustrates
# how Softimage automatically reverts any scripting change to this 
# preference after the script runs.
# 
from win32com.client import constants as cns
app = Application
# Current value of AutoInspect
app.LogMessage( app.GetUserPref(cns.siAutoInspect) )
# Toggle the orginal value and re-log the value
app.SetUserPref( cns.siAutoInspect, not(app.GetUserPref(cns.siAutoInspect)) )
app.LogMessage( app.GetUserPref(cns.siAutoInspect) )
# If your AutoInspect preference was enabled originally, the History Log 
# would display the following:
# INFO : True
# INFO : False
# VERBOSE : Restoring preference changed by script: Interaction.autoinspect
# If your AutoInspect preference was disabled originally, the History Log 
# would display the following:
# INFO : False
# INFO : True
# VERBOSE : Restoring preference changed by script: Interaction.autoinspect

2. VBScript の例

' Current value of AutoInspect
Application.LogMessage GetUserPref(siAutoInspect)
' Save old setting while turning on AutoInspect and display the new value
dim prevval
prevval = SetUserPref(siAutoInspect, False)
Application.LogMessage GetUserPref(siAutoInspect)
' Restore former setting and display its value again (explicitly reverting
' back to the original value isn't necessary, as Softimage will do that automatically
' after the script has run its course)
SetUserPref siAutoInspect, prevval
Application.LogMessage GetUserPref(siAutoInspect)
' If your AutoInspect preference was enabled originally, the History Log 
' would display the following:
' 'INFO : "True"
' 'INFO : "False"
' 'INFO : "True"

3. JScript の例

// Get a sphere and switch into T, Local and X/Z modes
CreatePrim("Sphere", "NurbsSurface");
TranslateTool();
SetUserPref("3D_TRANSFO_REFERENTIAL_CHANGED", 2);
SetUserPref("3D_TRANSFO_EDITED_AXIS_CHANGED", 5);

関連項目

GetUserPref Preferences.SetPreferenceValue